home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / robot150.zip / ROBOT.DOC < prev    next >
Text File  |  1992-02-16  |  20KB  |  661 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                                         Robot
  30.  
  31.  
  32.                            A Murder Motel Utility Program
  33.  
  34.  
  35.                                     Version 1.50
  36.  
  37.  
  38.                    Copyright 1989, 1990, 1991, 1992 by Duane Brown
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   Table of Contents
  71.  
  72.  
  73.      Uses for Robot  . . . . . . . . . . . . . . . . . . . . . . . . . .    1
  74.  
  75.      Setting up Robot  . . . . . . . . . . . . . . . . . . . . . . . . .    1
  76.  
  77.      Configuration File Structure  . . . . . . . . . . . . . . . . . . .    2
  78.  
  79.      A Note to Current Users of Robot  . . . . . . . . . . . . . . . . .    3
  80.  
  81.      Murder Motel Files Read/Written . . . . . . . . . . . . . . . . . .    3
  82.  
  83.      Revision History  . . . . . . . . . . . . . . . . . . . . . . . . .    4
  84.           Version 1.00
  85.           Version 1.10
  86.           Version 1.30 beta
  87.           Version 1.40
  88.           Version 1.50
  89.  
  90.      Future Enhancements to Robot  . . . . . . . . . . . . . . . . . . .    4
  91.  
  92.      Acknowledgements  . . . . . . . . . . . . . . . . . . . . . . . . .    5
  93.  
  94.      Registration and Other Legal Stuff  . . . . . . . . . . . . . . . .    6
  95.  
  96.      For Emergency Use Only  . . . . . . . . . . . . . . . . . . . . . .    7
  97.  
  98.      Registration Form . . . . . . . . . . . . . . . . . . . . . . . . .    8
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                              Murder Motel Robot Utility
  137.                                Written by Duane Brown
  138.                                     Version 1.50
  139.                    Copyright 1989, 1990, 1991, 1992 by Duane Brown
  140.  
  141.           This program is designed for the sysop that wishes to provide users
  142.        of the Murder Motel door, written by Sheldon Pasciak, currently being
  143.        updated by Chuck Valechek, with more than the average Murder Motel
  144.        game.  This program controls automated Murder Motel players (robots)
  145.        that run around and act like other players.  These robots will,
  146.        depending on how the sysop configures the program, do the following:
  147.  
  148.        a) Select a complete weapon and two different defenses, if they are
  149.           available,
  150.  
  151.        b) Select a target for killing,
  152.  
  153.        c) Move along the map and attempt a kill if the robot has a target,
  154.           and
  155.  
  156.        d) Log all of these activities to disk file for sysop use.
  157.  
  158.           This program is designed to be run as part of the daily maintenance
  159.        routine.  However, it can be run immediately after the Murder Motel
  160.        door if so desired. 
  161.  
  162.  
  163.        Uses for Robot
  164.        ==============
  165.  
  166.           Robot is great for keeping an active list of available targets for
  167.        your users if they are quite active in their killing sprees.  It also
  168.        can be used to "fill in" for some players who may be too busy to play
  169.        the game for a few days, yet want to stay alive (like busy sysops). 
  170.        If the program is configured correctly, users may not be able to tell
  171.        which players are robots and which ones are BBS users!
  172.  
  173.  
  174.        Setting up Robot
  175.        ================
  176.  
  177.           NOTE:  The program as distributed requires that a copy of
  178.        Brun45.exe be in the current directory or in the DOS path.  If
  179.        requested, I will provide you with a version that does not require the
  180.        Brun45.exe file.  However, since many doors use the Brunxx.exe files
  181.        (xx = 20, 30, 40, 45, etc), most likely you have Brun45.exe already. 
  182.        If you do not have this file, let me know and I will make the
  183.        Brun45.exe file available for download.
  184.  
  185.           Place a copy of robot.exe in your Murder Motel directory, along
  186.        with a copy of robot.cfg.  The syntax for Robot is:
  187.  
  188.        Robot filename.ext
  189.  
  190.        where filename.ext is the name of the configuration file.  I have
  191.        enclosed a sample configuration file called Robot.cfg which you can
  192.        use immediately. 
  193.  
  194.  
  195.  
  196.  
  197.        Robot                              1            A Murder Motel Utility
  198.  
  199.  
  200.  
  201.  
  202.           IMPORTANT NOTE:  Unregistered versions will ask you to enter a 4
  203.        digit random number before starting up.  Registration will remove this
  204.        prompt and allow you to run Robot unattended.
  205.  
  206.  
  207.        Configuration File Structure
  208.        ============================
  209.  
  210.        The structure of the configuration file is as follows:
  211.  
  212.  
  213.        Murder Motel Version
  214.        Logging Level
  215.        Log Filename
  216.        Revival Percent
  217.        Movement Percent
  218.        Get New Object Percent
  219.        Pick Target Percent
  220.        Number of Robot Moves
  221.        <list of up to 10 robot player names>
  222.  
  223.        <any comments you may want to put in>
  224.  
  225.        Murder Motel Version is the version number for your Murder Motel
  226.        setup.  The value specifed here must be either 2.0, 2,2, or 3.0.  It
  227.        is vitally important that this be specified correctly, as there are
  228.        small differences between the configuration file that Murder Motel
  229.        uses.  Weird things can happen if this is not set right.
  230.  
  231.        Logging Level represents the amount of detail that is represented in
  232.        the log file, from 1 to 4.  1 indicates only the most basic of
  233.        information, while 4 gives you so much information about the inner
  234.        workings of Robot you won't be able to stand it <grin>.  A level of 2
  235.        should be adequate for most people.
  236.  
  237.        Log Filename is the name of the file where Robot stores comments about
  238.        what happens while it is running.  If this line is left blank, no
  239.        logging to disk will occur.
  240.  
  241.        Revival Percent is an integer number from 0 to 100 that represents the
  242.        chance that a robot player will be brought back to life if found dead. 
  243.        A value of 0 means that the robot will never be revived, while 100
  244.        means that a robot player will always be revived.  
  245.  
  246.        Movement Percent is an integer number from 0 to 100 that represents
  247.        the chance that the robot will move around the map.  A value of 0
  248.        means there is no chance of movement, while 100 guarantees that
  249.        movement will occur.  
  250.  
  251.        Get New Object Percent is an integer number from 0 to 100 that
  252.        represents the chance that a robot will drop all objects and pick out
  253.        a new weapon and defenses.  0 means no changing of weapons, while 100
  254.        means a new set of objects will always be chosen.  
  255.  
  256.        Pick Target Percent is an integer number from 0 to 100 that represents
  257.        the chance that a robot will select a target for killing.  Setting
  258.        this number to 0 means that the robot player won't ever choose a
  259.        target (making the robots just dumb targets), while setting this to
  260.        100 means that the robots will become crazed, murdering maniacs that
  261.        can't stop killing people <grin>.  
  262.  
  263.        Robot                              2            A Murder Motel Utility
  264.  
  265.  
  266.  
  267.  
  268.  
  269.        Number of Robot Moves is the number of moves that the robots will use
  270.        if they  are able to move around.  Note that movement occurs according
  271.        to the Murder Motel map, using the directions available to normal
  272.        players, not by just choosing random locations and going to them. 
  273.        Thus, the robots will get 'lost' and spend more time wandering around
  274.        if you have a 'maze-type' setup.
  275.  
  276.        The rest of the file, upto a blank line, consists of the names of the
  277.        robot players.  Keep these names limited to one or two words, as that
  278.        is all that Murder Motel can handle.  Names are automatically
  279.        converterted to upper case.  The maximum number of robots that will be
  280.        read from the list is 10.
  281.  
  282.        You can place any additional comments after the last robot name. 
  283.        However, you must leave at least one blank line between the last robot
  284.        name and the beginning of the comments.  Note that I put in a brief
  285.        description of what all the lines mean (so you don't have to go back
  286.        and search for the documentation file if you don't know what a number
  287.        means).
  288.  
  289.  
  290.        A Note to Current Users of Robot
  291.        ================================
  292.  
  293.           Upgrading from Robot 1.0 or 1.1 is easy.  Overwrite the old
  294.        Robot.exe with the new Robot.exe, then using your robot.lst file as a
  295.        guide, add your Robot names to robot.cfg.  Don't forget to add your
  296.        change your batch files to reflect the new configuration filename.
  297.  
  298.           Upgrading from Robot 1.40 is even easier.  Overwrite the old
  299.        Robot.exe with the new Robot.exe, and insert the Murder Motel Version
  300.        number and Logging Level as the first two lines of your configuration
  301.        file, and you are ready to go.  
  302.  
  303.  
  304.        Murder Motel Files Read/Written
  305.        ===============================
  306.  
  307.        The program will read in the following files from the Murder Motel
  308.        directory:
  309.  
  310.        Murder.Cfg, People.Mmi, Objects.Mmi, Murder.Map, Squeals.Mmi, and
  311.        Empty.Mmi
  312.  
  313.        In addition, the program renames the original files to .bak files and
  314.        writes new data to these files:
  315.  
  316.        People.Mmi, Objects.Mmi, Squeals.Mmi, Motion.Mmi
  317.  
  318.        If a kill is attempted by any of the robots, Killed.Mmi is updated.
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.        Robot                              3            A Murder Motel Utility
  330.  
  331.  
  332.  
  333.  
  334.        Revision History
  335.        ================
  336.  
  337.        December 26, 1989
  338.        Version 1.00
  339.  
  340.        Initial release.
  341.  
  342.  
  343.        January 12, 1990
  344.        Version 1.10
  345.  
  346.        Converted to QuickBasic 4.5 (now requiring Brun45.exe), fixing several
  347.        bugs.  Now the robots choose two defenses only and a one complete
  348.        weapon, if the parts are available.
  349.  
  350.  
  351.        November 26, 1990
  352.        Version 1.30 beta
  353.  
  354.        Major upgrade.  Lost the source code for version 1.1, so had to start
  355.        off with the source for 1.0.  Added the following features:
  356.  
  357.        Robots actually do move!  Robots can pick targets, and attempt a kill,
  358.        following all of the usual Murder Motel rules for processing a kill.
  359.        Actions performed by the program can be logged to a disk file if
  360.        desired.  Registration key system added to encourage registrations. 
  361.        Logging of kills, attempts, etc. to Killed.Mmi.   
  362.  
  363.        (many beta versions later)...
  364.  
  365.  
  366.        January 21, 1991
  367.        Version 1.40 
  368.  
  369.        Many thanks to my beta bashing team for finding the bugs that skipped
  370.        even my scrutiny (and there were some doozies in there!). 
  371.  
  372.  
  373.        February 16, 1992
  374.        Version 1.50
  375.  
  376.        Maintenance release to accomodate Murder Motel 3.0.  Added color to
  377.        program.   
  378.  
  379.  
  380.        Future Enhancements to Robot
  381.        ============================
  382.  
  383.        Robot has grown a great deal since it's birth and first release on
  384.        Christmas Day, 1989.  I have included several ideas from my beta
  385.        testers in this version of Robot, and plan to add a lot more in the
  386.        upcoming months.  Here is summary of the some of the changes that will
  387.        be added to Robot in the near future:
  388.  
  389.        Individual percentage values for each robot, instead of forcing all
  390.        robots to have the same values (ie give each of the robots a different
  391.        'personality') [Ric Smith]
  392.  
  393.  
  394.  
  395.        Robot                              4            A Murder Motel Utility
  396.  
  397.  
  398.  
  399.  
  400.        Specify days of the week to run the robots (A for all, O for odd, E
  401.        for Even, etc) [Stephen King]
  402.  
  403.        Multiple Kills per robot (instead of the current method of not
  404.        selecting an additional victim after killing, or attempting to kill,
  405.        one person) [Stephen King]
  406.  
  407.        An Assassinate Mode:  Tell the robot to go and kill a user, picking
  408.        the right weapons/defenses, on sysop command. [Stephen King]
  409.  
  410.        Allow a list of players not to be chosen by the robots [Ric Smith]
  411.  
  412.        The reason why these changes are not included (yet) is that they will
  413.        cause a change to the configuration file structure.  I want a good,
  414.        workable program out of the 'door', so to speak, for others to use
  415.        before I start working on an even more enhanced version of Robot.
  416.  
  417.         
  418.        Acknowledgements
  419.        ================
  420.  
  421.        Sheldon Pasciak, for creating one of the best door games around
  422.        (Murder Motel).
  423.  
  424.        Many thanks go to my beta testing team:
  425.  
  426.        Kevin & Gary Graham, Fredericksburg, VA
  427.        Cracker Barrel, Fidonet 1:274/24
  428.        703-899-0020
  429.  
  430.        Mark & Diana Taylor, Fort Wayne, IN
  431.        Fire Station, Fidonet 1:236/10
  432.        219-447-3011
  433.  
  434.  
  435.        Paul King, Rochester, NY
  436.        The Omega Concern, Fidonet 1:260/241
  437.        716-292-0634
  438.  
  439.        Stephen King, Riverside, CA
  440.        Commnet-386
  441.        714-359-3189
  442.  
  443.        Ric Smith, Fredericksburg, VA
  444.        Spider's Web, Fidonet 1:274/19
  445.        703-752-0379
  446.  
  447.        John Schreiber, Falmouth, VA
  448.        Thunderbolt BBS, Fidonet 1:274/13, Echonet 50:5703/13
  449.        703-373-9289
  450.  
  451.        Cindy Edens, Satellite Beach, FL
  452.        Motel Florida, Fidonet 1:3610/6
  453.        407-773-2831
  454.  
  455.        Russell Femyer, Lemon Grove, CA
  456.        I.D.I.C, Fidonet 1:202/310
  457.        619-461-0982
  458.  
  459.  
  460.  
  461.        Robot                              5            A Murder Motel Utility
  462.  
  463.  
  464.  
  465.  
  466.        Robert York, Milton, WA
  467.        Doctor Debug's Domain
  468.        1-206-535-1542
  469.  
  470.  
  471.        And especially to:
  472.  
  473.        Mark Taylor, whose encouragement caused me to start re-working on
  474.        Robot, and for being my first registered user for any of my programs!
  475.  
  476.        Ric Smith, for finding the BIG BUG in the inaccurate altering of the
  477.        players status when killing/picking (glad you're a local call...we
  478.        spent enough time trying to figure this one out)
  479.  
  480.        Paul King, for reporting the squeals.mmi bug (fixed in 1.31 beta of
  481.        Robot) -- since my Squeal file has all 10 entries full, I never saw
  482.        that Robot 1.30 added the "0,0" entries (aka "A deleted user was found
  483.        at area # 0" squeals message).  
  484.  
  485.        Stephen King, for all of the suggestions mentioned above and helping
  486.        me out with finding the exact wording of the Killed.Mmi entries for
  487.        those 'unusual' circumstances. <grin>
  488.  
  489.        Cindy Edens, for being an all-around helpful tester and forcing me to
  490.        download many, many excellent RA utilities even though my phone bill
  491.        didn't want to <grin>.
  492.  
  493.  
  494.        Registration and Other Legal Stuff
  495.        ==================================
  496.  
  497.           If you find after a reasonable amount of time (around 30 days) that
  498.        Robot meets your needs, you must register the program.  After
  499.        receiving your registration key, you will be able to run Robot in
  500.        unattended (batch) mode.  I will also add your name to my mailing
  501.        list, give you advance notice for updates on this and my other
  502.        programs, and send you updated versions of any of my programs that you
  503.        have.
  504.  
  505.           Permission is granted to post this program on electronic Bulletin
  506.        Board systems.  Therefore, you are encouraged to upload the unaltered,
  507.        unmodified archive file to Bulletin Board Systems, even if you do not
  508.        use this program.  There are no warranties, express or implied, other
  509.        than that this software will take up space on your disk.  I have tried
  510.        to make this program as safe as possible, but I will not be held
  511.        responsible for any losses as the result from the use of this program.
  512.  
  513.           The registration fee is $10, payable by check or money order, to
  514.        Duane Brown at the address below.  Print out and fill in the requested
  515.        information and I will send you the key file, or the information
  516.        needed for you to create the key file, and instructions on how to
  517.        install this file.  I will send the key file to you via Netmail if you
  518.        are on either Fidonet, Echonet, or Youthnet, or call your BBS and
  519.        upload the key file.  If you wish for me to call your board and upload
  520.        the key, please set up an account under the name "Duane Brown" that
  521.        will allow uploading, and enter the password on the registration form. 
  522.  
  523.  
  524.  
  525.  
  526.  
  527.        Robot                              6            A Murder Motel Utility
  528.  
  529.  
  530.  
  531.  
  532.           If you do not want me to send the key file to you electronically, I
  533.        will send you instructions on how to create the key file by mail. 
  534.        However, if you have any additional comments, bug reports, etc, please
  535.        feel free to get in touch with me via Snail-mail at
  536.  
  537.        Duane Brown
  538.        100 Pewter Lane
  539.        Stafford, VA 22554-1518
  540.  
  541.        or call
  542.  
  543.        The End of the Line BBS
  544.        Stafford, Virginia
  545.        Data (703)720-1624, 24 hours a day.
  546.        Running Dbridge 1.31 with Remote Access 1.11 (registered)
  547.        accepting 300/1200/2400/9600 V.32 callers.
  548.        Fidonet 1:274/16, Echonet 50:5703/16, Youthnet 13:13/20, 13:2600/0.
  549.        Crash mail accepted.  Full access to first time callers.
  550.  
  551.  
  552.        For Emergency Use Only
  553.        ======================
  554.  
  555.        If you have a question that absolutely can not wait, you can call me
  556.        voice at (703)659-6302 at reasonable hours (i.e. before 9:30 pm
  557.        Eastern Time).  If I am available, I will do my best to help you out. 
  558.        However, I can diagnose problems better if I have a copy of your
  559.        Murder Motel files so I can look at them.  I am now studying for my BS
  560.        in Computer Science full time at George Mason University, so my time
  561.        is limited.
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.        Robot                              7            A Murder Motel Utility
  594.  
  595.  
  596.  
  597.  
  598.        Registration Form
  599.        =================
  600.  
  601.        Please fill out the following information, along with your check or
  602.        money order, and mail to:
  603.  
  604.        Duane Brown
  605.        100 Pewter Lane
  606.        Stafford, Virginia 22554-1518.
  607.  
  608.        Your registration will be processed within one day of receipt.  Thank
  609.        you for supporting shareware.
  610.  
  611.  
  612.        Program Registering:   ___Robot_1.50___
  613.  
  614.        Sysop Name: __________________________________________________________
  615.                     (case is significant!)
  616.  
  617.        BBS Name:  ___________________________________________________________
  618.                     (case is significant!)    
  619.  
  620.        BBS Software:        _________________________________________________
  621.  
  622.        Hours of Operation:  _________________________________________________
  623.  
  624.        Home Address:        _________________________________________________
  625.  
  626.                             _________________________________________________
  627.  
  628.        Voice Number:        ___________________________
  629.  
  630.        Send the Registration Key: Via Netmail? [ ] Uploading to Your BBS? [ ]
  631.                                   Snailmail (US Postal Service?) [ ] 
  632.  
  633.        Password:  ___________________________________________________________
  634.         (only needed if requesting 'Uploading to Your BBS?' box above)
  635.  
  636.        Where did you get this program?  _____________________________________
  637.  
  638.        Fidonet/Othernet Address(es):   ______________________________________
  639.  
  640.  
  641.        Any additional Comments/Suggestions (Use other sheets if necessary):
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.        Robot                              8            A Murder Motel Utility
  660.  
  661.